home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat2 / readlink.0 < prev    next >
Text File  |  1996-09-01  |  2KB  |  53 lines
  1.  
  2. READLINK(2)                UNIX Programmer's Manual                READLINK(2)
  3.  
  4. NNAAMMEE
  5.      rreeaaddlliinnkk - read value of a symbolic link
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.  
  10.      _i_n_t
  11.      rreeaaddlliinnkk(_c_o_n_s_t _c_h_a_r _*_p_a_t_h, _c_h_a_r _*_b_u_f, _i_n_t _b_u_f_s_i_z)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      RReeaaddlliinnkk() places the contents of the symbolic link _p_a_t_h in the buffer
  15.      _b_u_f, which has size _b_u_f_s_i_z. RReeaaddlliinnkk does not append a NUL character to
  16.      _b_u_f.
  17.  
  18. RREETTUURRNN VVAALLUUEESS
  19.      The call returns the count of characters placed in the buffer if it suc-
  20.      ceeds, or a -1 if an error occurs, placing the error code in the global
  21.      variable _e_r_r_n_o.
  22.  
  23. EERRRROORRSS
  24.      RReeaaddlliinnkk() will fail if:
  25.  
  26.      [ENOTDIR]     A component of the path prefix is not a directory.
  27.  
  28.      [ENAMETOOLONG]
  29.                    A component of a pathname exceeded {NAME_MAX} characters,
  30.                    or an entire path name exceeded {PATH_MAX} characters.
  31.  
  32.      [ENOENT]      The named file does not exist.
  33.  
  34.      [EACCES]      Search permission is denied for a component of the path
  35.                    prefix.
  36.  
  37.      [ELOOP]       Too many symbolic links were encountered in translating the
  38.                    pathname.
  39.  
  40.      [EINVAL]      The named file is not a symbolic link.
  41.  
  42.      [EIO]         An I/O error occurred while reading from the file system.
  43.  
  44.      [EFAULT]      _B_u_f extends outside the process's allocated address space.
  45.  
  46. SSEEEE AALLSSOO
  47.      stat(2),  lstat(2),  symlink(2) symlink(7),
  48.  
  49. HHIISSTTOORRYY
  50.      The rreeaaddlliinnkk() function call appeared in 4.2BSD.
  51.  
  52. 4.2 Berkeley Distribution        June 4, 1993                                1
  53.